home *** CD-ROM | disk | FTP | other *** search
/ CD Actual 1 / PC Actual CD 01.iso / share / dos / comunic / ged2dbf.arj / GED2DBF.DOC < prev    next >
Encoding:
Text File  |  1994-09-07  |  13.7 KB  |  400 lines
  1.  
  2.                              ┌───────────────────┐
  3.                              │      GED2DBF      │
  4.                              │   ═════════════   │
  5.                              │                   │
  6.                              │        por        │
  7.                              │   Iñaki Ecenarro  │
  8.                              │                   │
  9.                              │      Julio-94     │
  10.                              └───────────────────┘
  11.  
  12.   ──────────────────────────────────────────────────────────────────────────
  13.  
  14.   Indice:
  15.   ──────
  16.  
  17.   1. Introducción
  18.  
  19.   2. Instalación
  20.      2.1. Instalación de GED2DBF
  21.      2.2. Instalación de TXT2DBF
  22.      2.3. Instalación de MSG
  23.  
  24.   3. Configuración
  25.      3.1. Ejemplos de configuración
  26.  
  27.   4. Utilización
  28.      4.1. GED2DBF
  29.      4.2. TXT2DBF
  30.      4.3. MSG
  31.  
  32.   5. Palabras finales
  33.  
  34.   ──────────────────────────────────────────────────────────────────────────
  35.  
  36.   1.Introducción:
  37.   ──────────────
  38.  
  39.     Estas utilidades sirven para guardar mensajes de cualquier tipo de
  40.   base de mensajes (Hudson, Jam, etc) desde el Golded a un fichero con
  41.   formato DBF (dBase) y su asociado DBT, que incluye el texto de los
  42.   mensajes.
  43.  
  44.     El fichero incluye tres utilidades distintas:
  45.  
  46.     - GED2DBF: sirve para pasar los mensajes desde el GoldEd al fichero
  47.                DBF mientras se van leyendo los mensajes, pulsando una
  48.                tecla. Requiere GoldEd 2.42 o superior.
  49.  
  50.     - TXT2DBF: sirve para pasar los mensajes desde un fichero de texto
  51.                escrito por GoldEd al fichero DBF.
  52.  
  53.     - MSG:     sirve para leer los ficheros MSG.DBF y MSG.DBT, que
  54.                incluyen los mensajes guardados. Su presentación y
  55.                funcionamiento es similar al GoldEd.
  56.  
  57.  
  58.   2.Instalación:
  59.   ─────────────
  60.  
  61.     Es aconsejable crear un directorio en el que se incluyan las tres
  62.   utilidades, aunque pueden incluirse en cualquier otro (por ejemplo, en
  63.   el que esté el GoldED). Los programas GED2DBF y TXT2DBF crearán los
  64.   ficheros MSG.DBF y MSG.DBT en el directorio en el que se encuentren
  65.   ellos. En los puntos siguientes, se supondrá que los tres programas se
  66.   encuentran en el directorio C:\MSG
  67.  
  68.      2.1.Instalación de GED2DBF:
  69.      ──────────────────────────
  70.  
  71.        Requiere Golded 2.42 o superior. Para instarlo hay que hacer los
  72.      siguientes cambios en los ficheros de configuración de Golded:
  73.  
  74.      En el fichero GOLDED.CFG, añadir las líneas:
  75.  
  76.         EXTERNOPTIONS NoCls
  77.         EXTERNUTIL 01 C:\MSG\GED2DBF.EXE @File
  78.  
  79.      El número 01 puede ser sustituido por otros (consultar manual de
  80.      GoldEd).
  81.  
  82.      En el fichero GOLDKEYS.CFG:
  83.  
  84.         ^F10 EXTERNUTIL01
  85.  
  86.        De esta forma se ejecutará el programa GED2DBF al pulsar la tecla
  87.      Control-F10. Puede utilizarse cualquier otra combinación de teclas
  88.      (consular manual de GoldEd).
  89.        El número detrás de la palabra EXTERNUTIL (en este caso 01) debe
  90.      ser el mismo que el puesto anteriormente en el fichero GOLDED.CFG.
  91.  
  92.  
  93.      2.2. Instalación de TXT2DBF:
  94.      ───────────────────────────
  95.  
  96.        El programa TXT2DBF no requiere ninguna instalación para su
  97.      utilización normal. Sin embargo, puede instalarse para utilizarlo
  98.      desde dentro de GoldEd, de una forma parecida a GED2DBF, aunque es
  99.      aconsejable utilizar este último. Para ello, se deberán hacer los
  100.      siguientes cambios en los ficheros de configuración de GoldEd:
  101.  
  102.  
  103.      En el fichero GOLDED.CFG, añadir la línea:
  104.  
  105.        EXTERNUTIL 01 C:\MSG\TXT2DBF.EXE -d ABCD.TXT
  106.  
  107.        El número 01 puede ser sustituido por cualquier otro (consultar el
  108.      manual de GoldED), y el nombre de fichero del final (ABCD.TXT)
  109.      también puede ser sustituido por otro.
  110.  
  111.      En el fichero GOLDKEYS.CFG, añadir:
  112.  
  113.         ^F10  Macro READwritemsg "Dabcd.txt" Enter ExternUtil01
  114.  
  115.        De esta forma, al pulsar Control-F10 (puede utilizarse cualquier
  116.      otra combinación de teclas), GoldED guardará el mensaje actual en
  117.      el fichero ABCD.TXT (este nombre puede cambiarse, pero debe
  118.      coincidir con el puesto en el fichero GOLDED.CFG) y llamará a
  119.      TXT2DBF, que leerá el mensaje de ese fichero y lo guardará en el
  120.      fichero MSG.DBF.
  121.  
  122.        El problema es que este macro de GoldEd no funciona si el fichero
  123.      ABCD.TXT existe en disco, por lo que hay que tener cuidado de que
  124.      al guardar el mensaje no exista dicho fichero.
  125.  
  126.  
  127.      2.3. Instalación de MSG:
  128.      ───────────────────────
  129.  
  130.        El programa MSG no requiere ninguna instalación, simplemente debe
  131.      estar en el mismo directorio que los ficheros de mensajes MSG.DBF y
  132.      MSG.DBT.
  133.  
  134.  
  135.   3. Configuración:
  136.   ────────────────
  137.  
  138.     Los programas GED2DBF y TXT2DBF pueden ser configurados para
  139.   reconocer distintos formatos de fecha, cambiar los colores, etc. La
  140.   configuración para ambos programas debe estar en el fichero
  141.   GED2DBF.INI, que deberá estar en el mismo directorio que ambos
  142.   programas. Este fichero tiene un formato similar a los ficheros de
  143.   configuración de Windows (WIN.INI, SYSTEM.INI, etc.)
  144.  
  145.     Los comandos que se pueden incluir en el fichero GED2DBF.INI son:
  146.  
  147.     - Sección [Fecha]:
  148.  
  149.       GoldEd permite definir distintos formatos de fecha, por lo que
  150.     habrá que configurar GED2DBF y TXT2DBF para que reconozcan esos
  151.     formatos.
  152.  
  153.       - Comienzo: indica la columna en la que comienza la fecha. La
  154.         primera columna (la izquierda del todo) es la número 0. El valor
  155.         por defecto es 64.
  156.  
  157.       - Formato: indica el orden de día, mes y año en la fecha. Valores
  158.         válidos son DMA (día, mes, año), MDA (mes, día, año), DAM, MAD,
  159.         ADM y AMD. El valor por defecto es DMA.
  160.  
  161.       - Separador: indica el carácter que separa el día, el mes y el
  162.         año. El valor por defecto es un espacio. Otros valores posibles
  163.         son el guión (-), la barra (/), el punto (.), etc.
  164.  
  165.       - Mes1: indica el nombre del primer mes del año (Enero). El valor
  166.         por defecto es "Ene" (sin comillas). Otros valores posibles son
  167.         "Enero" o "01" (este último en caso de que el mes se escriba con
  168.         números).
  169.  
  170.         Igual que Mes1, existe Mes2 a Mes12, y sus valores por defecto
  171.         son Feb, Mar, Abr, May, Jun, Jul, Ago, Sep, Oct, Nov, Dic.
  172.  
  173.     - Sección [ged2dbf]:
  174.  
  175.         Estos comandos sólo afectan al programa GED2DBF, no sirven para
  176.       el programa TXT2DBF.
  177.  
  178.       - Marco: define el color del marco para los mensajes de error de
  179.         GED2DBF. El valor por defecto es 79 (blanco sobre rojo). Los
  180.         valores para otros colores se calculan de la siguiente forma:
  181.  
  182.         0 Negro         8 Negro claro
  183.         1 Azul          9 Azul claro
  184.         2 Verde        10 Verde claro
  185.         3 Cyan         11 Cyan claro
  186.         4 Rojo         12 Rojo claro
  187.         5 Magenta      13 Violeta claro
  188.         6 Marrón       14 Amarillo
  189.         7 Blanco       15 Blanco claro
  190.  
  191.         Para colores de fondo sólo pueden utilizarse los siete primeros,
  192.         y para color de los caracteres pueden utilizarse los quince.
  193.         Para calcular el color, se multiplica el número del color de
  194.         fondo deseado por 16 y se le suma el color de caracteres
  195.         deseado. Por ejemplo, si se quiere que el marco tenga un color
  196.         blanco claro sobre fondo azul, el color sería: 1*16 + 15 = 31
  197.  
  198.       - Interior: define el color del interior del marco en los mensajes
  199.         de error de GED2DBF. El valor por defecto es 79.
  200.  
  201.       - Sombra: define el color de la sombra del marco en los mensajes
  202.         de error de GED2DBF. El valor por defecto es 7
  203.  
  204.       - SonidoOK: define si se desea o no escuchar un sonido cuando
  205.         GED2DBF guarda con éxito un mensaje. El valor por defecto es Sí.
  206.         Valores posibles son Sí y No.
  207.  
  208.       - SonidoError: define si se desea o no escuchar un sonido cuando
  209.         GED2DBF presenta un mensaje de error. El valor por defecto es Sí.
  210.         Valores posibles son Sí y No.
  211.  
  212.  
  213.      - 3.1. Ejemplos de configuración:
  214.      ────────────────────────────────
  215.  
  216.        Si tenemos la siguiente cabera de mensaje, la configuración podría
  217.      ser:
  218.  
  219. ─ xxxxxxxx (9:999/99.99) ───────────────────────────────────────────── xxxxxxx
  220.  Msg  : 999 of 999 - 999
  221.  From : xxxxxxxxxxxxxxxxxxxxx               9:999/999.99    Mar 24-05-1994
  222.  To   : xxxxxxxxxxxxxxxxxxxxx
  223.  Subj : xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  224. ───────────────────────────────────────────────────────────────────────────────
  225.  
  226. [Fecha]
  227. Formato=DMA
  228. Separador=-
  229. Comienzo=64
  230. Mes1=01
  231. Mes2=02
  232. Mes3=03
  233. Mes4=04
  234. Mes5=05
  235. Mes6=06
  236. Mes7=07
  237. Mes8=08
  238. Mes9=09
  239. Mes10=10
  240. Mes11=11
  241. Mes12=12
  242.  
  243. [ged2dbf]
  244. Marco=31
  245. Interior=30
  246. Sombra=79
  247. SonidoOK=No
  248. SonidoError=Si
  249.  
  250.      Otro ejemplo:
  251.  
  252. ─ xxxxxxxx (9:999/99.99) ───────────────────────────────────────────── xxxxxxx
  253.  Msg  : 999 of 999 - 999
  254.  From : xxxxxxxxxxxxxxxxxxxxx               9:999/999.99    Mayo 24 1994
  255.  To   : xxxxxxxxxxxxxxxxxxxxx
  256.  Subj : xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  257. ───────────────────────────────────────────────────────────────────────────────
  258.  
  259. [Fecha]
  260. Formato=MDA
  261. Separador=
  262. Comienzo=60
  263. Mes1=Enero
  264. Mes2=Febrero
  265. Mes3=Marzo
  266. Mes4=Abril
  267. Mes5=Mayo
  268. Mes6=Junio
  269. Mes7=Julio
  270. Mes8=Agosto
  271. Mes9=Septiembre
  272. Mes10=Octubre
  273. Mes11=Noviembre
  274. Mes12=Diciembre
  275.  
  276. [ged2dbf]
  277. Marco=31
  278. Interior=31
  279. Sombra=79
  280. SonidoOK=Si
  281. SonidoError=Si
  282.  
  283.  
  284.   4. Utilización:
  285.   ──────────────
  286.  
  287.      4.1. GED2DBF:
  288.      ────────────
  289.  
  290.        Una vez instalado correctamente, mientras se leen los mensajes
  291.      con GoldEd, cuando se quiera guardar un mensaje se pulsa la tecla
  292.      asociada al programa (en el ejemplo de instalación era Control-F10)
  293.      y el mensaje se guardará.
  294.  
  295.      
  296.      4.2. TXT2DBF:
  297.      ────────────
  298.  
  299.        Si se quiere utilizar desde dentro de GoldEd, la utilización será
  300.      igual que GED2DBF, pulsando la tecla asociada desde dentro de
  301.      GoldED.
  302.        Para utilizarlo desde la línea de comandos, hay que pasarle el
  303.      nombre del fichero que incluye los mensajes. Por ejemplo:
  304.  
  305.        TXT2DBF golded.out
  306.  
  307.        Puede utilizarse el parámetro -d, que después de leer los
  308.      mensajes borrará el fichero de texto.
  309.  
  310.        TXT2DBF -d golded.out
  311.  
  312.      4.3. MSG:
  313.      ────────
  314.  
  315.        El programa MSG se ejecuta sin parámetros y dentro de él las
  316.      teclas que se pueden utilizar son:
  317.  
  318.      Izquierda/Derecha      Ir al mensaje anterior/siguiente
  319.      Origen/Fin             Ir al primer/último mensaje
  320.      Arriba/Abajo
  321.      Página Arriba
  322.      Página Abajo           Desplazar el texto del mensaje
  323.      +/-                    Ir al siguiente/anterior mensaje con
  324.                             la misma cabecera.
  325.  
  326.      A                      Seleccionar un área.
  327.                             Al seleccionar un área, MSG mostrará sólo
  328.                             los mensajes que pertenezcan a ese área.
  329.                             Para borrar la selección, pulsar la tecla K.
  330.  
  331.      Del                    Marcar/Desmarcar como borrado el mensaje actual.
  332.                             En la parte superior derecha de la pantalla
  333.                             aparecerá la palabra "Del" si el mensaje
  334.                             está marcado para borrado.
  335.  
  336.      P                      Borrar todos los mensajes marcados para borrado.
  337.                             Este borrado es definitivo. ¡¡Cuidado!!
  338.  
  339.      F                      Buscar un cadena.
  340.                             La búsqueda se realiza tanto en el texto del
  341.                             mensaje como en la cabecera. La búsqueda se
  342.                             realiza por defecto hacia adelante. Para
  343.                             buscar hacia detrás, incluir un guión (-)
  344.                             antes de la cadena de búsqueda.
  345.  
  346.      N                      Repetir búsqueda anterior, en el mismo
  347.                             sentido en el que se hizo la primera
  348.                             búsqueda.
  349.  
  350.      S                      Establecer un filtro.
  351.                             Para utilizar esta opción es aconsejable
  352.                             tener ciertos conocimientos de lenguaje
  353.                             XBase. Lo que hace el programa es utilizar
  354.                             el comando XBase SET FILTER TO. Filtros
  355.                             válidos serían:
  356.  
  357.                                AREA="JUEGOS"
  358.                                FROM="Un nombre" .AND. TO="Otro Nombre"
  359.  
  360.                               Los campos del fichero MSG.DBF son:
  361.  
  362.                                  Nombre   Tipo  Longitud  Dec
  363.                                  ────────────────────────────
  364.                                  AREA      C       30      0
  365.                                  FROM      C       35      0
  366.                                  FROMAD    C       15      0
  367.                                  DATE      D        8      0
  368.                                  TO        C       35      0
  369.                                  SUBJECT   C       75      0
  370.                                  TEXT      M       10      0
  371.  
  372.      D                      Borrar el filtro. También sirve para borrar
  373.                             la selección de área establecida con la
  374.                             tecla A.
  375.  
  376.      L                      Listar los mensajes.
  377.  
  378.      W                      Escribir el mensaje actual en un fichero de
  379.                             texto.
  380.  
  381.      F1                     Ayuda
  382.  
  383.      Esc                    Abandonar el programa
  384.  
  385.  
  386.  
  387.   5. Palabras finales
  388.   ───────────────────
  389.  
  390.     GED2DBF y TXT2DBF han sido escritos en Borland C++ 3.1, y MSG ha sido
  391.   escrito en Clipper.
  392.  
  393.     Dudas, errores, sugerencias, o lo que sea a:
  394.  
  395.     Iñaki Ecenarro   FidoNet: 2:344/13.20
  396.                               2:344/19.22
  397.  
  398.   ──────────────────────────────────────────────────────────────────────────
  399.  
  400.